home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / anywhere.arc / ANYWHERE.DOC < prev    next >
Encoding:
Text File  |  1986-03-01  |  6.9 KB  |  186 lines
  1. ANYWHERE.EXE  - A modification to Where for multiple hard disk users.
  2.  
  3. Anywhere grew out of a need for our corporate users who have installed
  4. 60 Meg Priam drives to search multiple hard disk directories for files
  5. matching a particular file string.  One of our users had discovered
  6. WHERE.C in PC TECH JOURNAL and asked me to convert it to compile on his
  7. Lattice 2.14 C compiler.  After the program was distributed they came
  8. back with "It works fine but what we really need is a program that can
  9. search all our drives if we want it too.".  Since not everyone had the
  10. same number of Hard drives I decided to utilize the set command to create
  11. an environment string that could be used to guide WHERE as to what drives
  12. should be searched.  By doing this a user can place the set command in
  13. their autoexec.bat file tailored to his particular hard disk setup.  So
  14. far no complaints.
  15.  
  16.                        John Teichert Jr
  17.                        Information System Center
  18.                        117 14th Street
  19.                        Atlanta, Georgia 30309
  20.                        (404)-892-2400 x346
  21.  
  22. DISTRIBUTION RIGHTS:
  23.  
  24. WHERE - Originally Written by Mark S. Ackerman with the following copyright.
  25.  
  26.   PROGRAM IS WRITTEN IN MARK WILLIAMS  M W C 8 6  LANGUAGE
  27.   Copyright 1984, 1985 by Mark S. Ackerman.  Permission is
  28.   granted for unlimited copies if not sold or otherwise
  29.   exchanged for gain.
  30.   PUBLISHED IN PC TECH JOURNAL - OCT '85 - VOL 3, NO. 10
  31.  
  32. ANYWHERE - Modifications to WHERE to allow mulitiple disk drives to be searched.
  33.  
  34.     Program modifications written to Microsoft Version 3.00 C compiler
  35.     specifications.
  36.     Modifications: Copyright 1985, 1986 by John Teichert Jr.
  37.     Permission is granted to utilize the modifications for unlimited
  38.     distribution if not sold or otherwise exchanged for gain.
  39.  
  40. WARRANTIES:
  41.  
  42.     NONE.  Requires DOS 2.x or 3.x to be utilized.
  43.  
  44.     ANYWHERE is distributed to the Public Domain as an ARCHIVE file
  45.     utilizing ARC50.EXE as the compression routine.  It consists of three
  46.     files.
  47.         1.  AW.EXE        Executable Code.
  48.         2.  ANYWHERE.C        Program source.
  49.         3.  ANYWHERE.DOC    Documentation.
  50.  
  51. PROGRAM DESCRIPTION:
  52.  
  53.     ANYWHERE Locates files on hard drives on the IBMPC.  Can be setup to
  54.     search mulitple hard drives or diskettes utilizing an environment
  55.     string.
  56.  
  57. PROGRAM USAGE:
  58.  
  59.         AW [d:][\path\]filespec
  60.  
  61. Required parameters:
  62.  
  63.         filespec    the file specification that ANYWHERE is to
  64.                 search for.  Must include the extension if
  65.                 ANYWHERE is to resolve the filespec correctly
  66.                 since nothing will be appended to the specifi-
  67.                 cation.  Can (and most times will) include
  68.                 DOS global substitution characters "*" and "?".
  69.  
  70. Optional parameters:
  71.  
  72.         d:        A drive specifier to tell ANYWHERE to restrict
  73.                 the search to a particular drive.
  74.  
  75.         \path\        Restricts ANYWHERE to begin searching from the
  76.                 specified path instead of begining at the root
  77.                 directory.
  78.  
  79. Usage Example:
  80.  
  81.         AW D:FY85*.WK?
  82.  
  83.         ANYWHERE is to search the "D" drive for any file with FY85
  84.         as the first four characters and  WK as the first and second
  85.         characters of the extension.  The third charcter of the
  86.         extension can be anything. (i.e. Lotus 123 version 1a and
  87.         version 2 worksheets dealing with fiscal year 1985).  The
  88.         is to begin in the ROOT directory of the "D" drive.
  89.  
  90.         AW \LOTUS\*.PRN
  91.  
  92.         ANYWHERE is to search the current working directory and any
  93.         directories specified in the AWDISK= environment string for
  94.         files that are under the LOTUS main subdirectory and have
  95.         the extension .PRN.
  96.  
  97. Environment String Specification:
  98.  
  99.         set AWDISK=d:[;d:[;d:.....d:]]
  100.  
  101. Required Parameters:
  102.  
  103.         NONE        If the set command is issued without any para-
  104.                 meters it will nullify the Environment string
  105.                 and ANYWHERE will only search the current
  106.                 working directory or the specified drive if
  107.                 one was given in the command line parameter.
  108.  
  109. Optional Parameters:
  110.  
  111.         d:        Allows ANYWHERE to search multiple drives that
  112.                 are specified in the Environment string as well
  113.                 as the current working directory.
  114.  
  115. Environment Examples:
  116.  
  117.         set AWDISK=c:
  118.  
  119.         ANYWHERE is to search the "C" drive and the current working
  120.         directory if no drive specifier is given.
  121.  
  122.         SET AWDISK=C:;E:;D:
  123.  
  124.         ANYWHERE is to search the "C" drive, the "E" drive, and the
  125.         "D" drive as well as the default directory in the order given
  126.         if no drive specifier is given.
  127.  
  128. Restrictions:
  129.  
  130.     The program cannot repeat cannot be used with any version of DOS
  131.     below 2.x.
  132.  
  133.     AWDISK= must be capitalized.  This is done automatically by
  134.     DOS 3.0.  Use set without any operands to ensure that this is
  135.     true in prior or future releases.
  136.  
  137.     A limit of 16 drives can be specified in the environment string.
  138.     If 16 drives are specified (Lord amighty why are you running DOS)
  139.     the current working directory cannot be added to the search list.
  140.  
  141.     The program was linked using an 8K stack space.  If this proves
  142.     to be insuffiecient (Hasn't yet though) the stack must be increased
  143.     using Microsoft's EXEMOD program distributed with the Microsoft's
  144.     Assembler 4.0 or C compiler 3.0 as well perhaps with all the new
  145.     versions of their other compilers.  The program checks for stack
  146.     usage so it will inform you if there is a stack problem.
  147.  
  148. BUGS: !!!!!!!!!!!!!!!!!!!!!!
  149.  
  150.     If the environment string is terminated with a semicolon the current
  151.     working directory will not be searched.  Regard this as either a bug
  152.     or a feature.  Take your choice.
  153.  
  154.     The file spec must be legal (less than 64 characters including drive
  155.     specifiers.  If not string corruption can occur with unpredictable
  156.     results.  (i.e. Strange file names etc.)).  This includes drive
  157.     specifiers in the environment string.
  158.  
  159.     No validation is performed on the Drive specifiers.  They are accepted
  160.     as written.  Message "Problem with looking thru........." will appear.
  161.  
  162. Operation:
  163.  
  164.     ANYWHERE first determines whether or not a drive specification was
  165.     contained in the command line parameter.  If a drive specifier was
  166.     included then no search is done for additional drives and the program
  167.     immediately begins searching for the filespec given on the command
  168.     line.  If a path is given as well the search will be restricted to
  169.     that drive and path.  This is quickest form of searching.
  170.  
  171.     If there was no drive specification a search is made of the environment
  172.     strings to see if any match the AWDISK= string.  If no environment
  173.     string matches then only the current working directory is searched
  174.     for the file spec.
  175.  
  176.     If an environment string is located the drives are extracted in the
  177.     the order given.  Each drive found is examined to see if it matches
  178.     the drive of the current working directory.  If the current working
  179.     directory is not matched up to a drive in the environment string it
  180.     is added to the list of drives to search as the last drive.
  181.  
  182.     For each drive specified in the environment string as well as the
  183.     default drive ANYWHERE begins from the ROOT directory unless a path
  184.     is specified searching for matches on the filespec given on the
  185.     command line.
  186.